home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / EZMAK100.ZIP;1 / EASYMAKE.DOC < prev    next >
Encoding:
Text File  |  1993-01-15  |  8.4 KB  |  254 lines
  1.                   *****************************
  2.                   *      EasyMake V1.00       *
  3.                   *      Copyright 1993       *
  4.                   *                           *
  5.                   *       Programmed By       *
  6.                   *                           *
  7.                   *     Shawn Sorichetti      *
  8.                   *****************************
  9.  
  10.  
  11.                         Table of Contents
  12.  
  13.      Section                                      Page
  14.  
  15.      Introduction..................................1
  16.      License Agreement.............................2   
  17.      Disclaimer....................................2
  18.      Registration..................................2
  19.      Note from the Programmer......................3
  20.  
  21.      Part I
  22.           Comments.................................4
  23.      Part II
  24.           Single Files.............................5
  25.      Part III
  26.           Multiple Files...........................6
  27.      Part IV
  28.           Where I can be Reached...................7
  29.                                                              -1-
  30.  
  31.  
  32.  
  33.                           Introduction
  34.  
  35.      EasyMake is exactly what the title implies, an easy to use
  36. make utility. What makes it easy to use is that every command that
  37. is used you already know. Each command is chosen from Dos, such as
  38. * to specify multiple files, and popular programming languages, /*
  39. and (* from C and Pascal respectively. Also EasyMake uses common
  40. sense, everyone knows what > sign means. I designed EasyMake to be
  41. a quick and simple make utility. That is just what it is. It has
  42. the same implements as any commercial make utility but takes a
  43. quarter of the time. If you would rather spend your time
  44. programming than fooling around with a make file EasyMake is for
  45. you.
  46.  
  47.                                                              -2-
  48.  
  49.  
  50.  
  51.                         Licence Agreement
  52.  
  53. Free trial:
  54.  
  55.      Anyone can use EasyMake for free. If you wish upgrades and bug fixes
  56. you will have to register it. The types of registration are described
  57. throughout the rest of the manual.
  58.  
  59. Personal:
  60.  
  61.      EasyMake can only be used on one computer at a time by the
  62. person it is registered to. This means that the person who EasyMake
  63. is registered to can use it on any computer but only he/she can use
  64. it.
  65.  
  66. Corporate/Business:
  67.  
  68.      EasyMake can be used on any number of computers by any number
  69. of users. As long as it is used in the corporation/business. If an
  70. employee wishes to use EasyMake at home he must register it
  71. personally.
  72.  
  73.  
  74.                            Disclaimer
  75.  
  76.      Shawn Sorichetti, the author, is in no way responsible for any
  77. ill results caused directly or indirectly by use of this product.
  78.  
  79.  
  80.                           Registration
  81.  
  82.      There are two ways to register EasyMake unfortunately both
  83. require the use of "snail mail". The first way is to fill out the
  84. form in register.doc. Send it and the registration fee for your
  85. purpose with $5 shipping and handling. Make sure that you check
  86. beside 5 1/4 or 3 1/2 disk size. A copy registered in your name
  87. will be mailed to you.
  88.      
  89.      The second way is a little quicker. If you are able to call
  90. C.A.P. (EasyMake's support BBS) then check the 'Can Call' box in
  91. register.doc. Fill the rest out. * Note: There is no need to check
  92. disk size or send shipping and handling fee. Send it with the
  93. registration fee, for your purpose. Call C.A.P. a week after you
  94. send your registration form. A private message with your personal
  95. registration key will be waiting for you in conference 4
  96. (EasyTools).
  97.      
  98.      These methods of registration will have to do for now. If
  99. EasyMake becomes popular I will try and get credit card payment and
  100. instant registration.
  101.                                                              -3-
  102.  
  103.  
  104.  
  105.                     Note from the Programmer
  106.  
  107.      Because I am using this as a stepping stone and a learning
  108. experience registration costs are low. As well any version number
  109. that doesn't end in .00 the registered user receives for free
  110. (except shipping and handling if applicable). I hope that you like
  111. EasyMake and will continue to support it. Thank you.
  112.  
  113.                                                 Shawn Sorichetti.
  114.  
  115.                              Special Thanks
  116.  
  117.         There are a couple of people that I would like to thank for all
  118. of their help and units.
  119.  
  120. Jeff Gerchkow
  121. Guy MCLoughlin
  122. David Doty
  123. David Dubois
  124.  
  125.         Thank you all of you.
  126.  
  127.                                                              -4-
  128.  
  129.  
  130.  
  131.                         Part I: Comments
  132.  
  133.      EasyMake allows for comments in the make file. The comments
  134. must be on a line separate from anything else. Comments must begin
  135. with either (* or /*. Because this is rater hard to explain I will
  136. show legal and illegal comments.
  137.  
  138. Legal
  139.      /* One legal comment
  140.      (* A second legal comment
  141.  
  142. Note the above comments could be closed using */ or *) but is not
  143. necessary.
  144.  
  145. Illegal
  146.      /* this
  147.      is an illegal comment
  148.      !renprg.bat /* So is this
  149.      (* And this *) !renprg.bat
  150.                                                              -5-
  151.  
  152.  
  153.  
  154.                       Part II: Single Files
  155.  
  156. The > command:
  157.  
  158.      EasyMake uses the > command to compare file times. The
  159. following compares the times of a file source and object:
  160.  
  161.                          Source > Object
  162.  
  163. The condition is true if the time and date of source is greater
  164. (newer) than that of object.
  165.  
  166. The = command:
  167.  
  168.      If the > command is true you will want EasyMake to perform
  169. some dos command (about 98% of the time re-compile source code)
  170. this is where the = command come into play. The > and = commands
  171. work together. If a > is found and is not followed by a comment,
  172. blank line, which = must follow after, or = EasyMake will report
  173. and Error. An example of the > and = commands together is:
  174.  
  175.                          source > object
  176.                          =compile source
  177.  
  178.      If the condition imposed by the > command is true EasyMake
  179. will execute the = command. If it is false EasyMake reads until the
  180. = command then begins to interpret the make file from the following
  181. line.
  182.                                                              -6-
  183.  
  184.  
  185.  
  186.                      Part III: Multiple Files
  187.  
  188. The > and = commands:
  189.  
  190.      EasyMake tries to keep things simple. Because of this EasyMake
  191. uses the same commands for multiple files as single files with the
  192. following changes.
  193.  
  194. Specifying Multiple Files:
  195.  
  196.      To use multiple files in EasyMake you must use an *.extension.
  197. If you use anything else EasyMake will not treat it as a multiple
  198. file. Two example of multiple files in Easymake are:
  199.  
  200.                           *.SRC > *.OBJ
  201.                         *.OBJ > THIS.EXE
  202.  
  203.      EasyMake will compare the times of multiple files to that of
  204. single files but not the other way around.
  205.  
  206. The =! command:
  207.  
  208.      When linking files you don't link one file at a time you
  209. generally do it all at once. Therefore EasyMake needs a way to
  210. recognize this state. Enter the =! command. This command tells
  211. EasyMake to concatenate all multiple files, separate them by commas
  212. ", ", and use all of them in one command.
  213.  
  214.                           =!link *.obj
  215.  
  216.  
  217.                  Part IV: Miscellaneous Commands
  218.  
  219.      EasyMake has only one misc. command. It is the ! command. This
  220. tells EasyMake no matter what to execute this command.
  221.  
  222.                            !renprg.bat
  223.  
  224.                                                              -7-
  225.  
  226.  
  227.  
  228.                      Where I can be Reached.
  229.  
  230.      If for any reasons, bugs, questions, comments (good or bad),
  231. or suggestions, I can be reached at the EasyTools support BBS:
  232.  
  233.                              C.A.P.
  234.                           (416)773-6109
  235.                           (416)726-1827
  236.                          In conference 4
  237.  
  238.      If C.A.P. is long distance from you I can be reached
  239. electronic mail on the following ShareWare and Pascal conferences:
  240.  
  241.                             City2City
  242.                               Nanet
  243.                              UNI'net
  244.                              Intelec
  245.                              Echonet
  246.  
  247.      Or if you prefer "snail mail" at:
  248.  
  249.                          S. Sorichetti 
  250.                          2 Bayberry St.
  251.                          Stouffville, ON
  252.                          Canada        
  253.                          L4A 7Z1       
  254.